home *** CD-ROM | disk | FTP | other *** search
/ Disc to the Future 2 / Disc to the Future Part II Programmer's Reference (Wayzata Technology)(6013)(1992).bin / MAC / THINKC / 4_0 / MACPROTO / MACPROTO._TC
Text File  |  1990-04-16  |  6KB  |  170 lines
  1. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! C A U T I O N !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  2. THIS UPDATE IS NOT FROM SYMANTEC AND IN NO WAY REFLECTS SYMANTEC APPROVAL.
  3. THE UPDATE IS PROVIDED AS A SERVICE TO OTHER USERS OF THINK C WHO USE THE MAC TOOLBOX
  4. PROTOTYPES FILE (MACPROTO.H).  THESE CHANGES ARE NOT GUARANTEED AND SHOULD BE USED AT YOUR
  5. OWN RISK.  WE ARE NOT RESPONSIBLE FOR ANY ERRORS OR OMISSIONS.
  6.  
  7.  
  8.  
  9. MACPROTO TCL UPDATE INSTRUCTIONS
  10. ================================
  11. Copyright ⌐ 1990 Johnston/Johnston. All rights reserved.
  12. 4/13/90
  13.  
  14. INTRODUCTION
  15. ============
  16. Since Symantec released the THINK Class Library, we've found, and users have
  17. reported, several incompatibilities with the Mac Toolbox Prototypes. This update 
  18. fixes these bugs
  19.  
  20.  
  21. This update uses a program called AutoWeave to create new TCL source files
  22. from the updated v4.0.2 THINK C Class Library files. It applies a set of 
  23. "differences" files to the patched THINK Class Library source files that 
  24. you have updated to version 4.0.2 to create new updated source files.
  25.  
  26. There are two things to watch out for:
  27.  
  28.     Ñ    The AutoWeave program assumes that you have not changed
  29.         how the THINK Class Library source files are organized.
  30.         All of the TCL source files should be a folder called
  31.         THINK Class Library which should contain two folders called
  32.         Core Classes and More Classes.
  33.  
  34.     Ñ    If you modified any of the original source files, you
  35.         should move them to a different folder or rename them.
  36.         Otherwise, the AutoWeave program will replace them with
  37.         updated versions, and your changes will be lost.
  38.     
  39. ***IMPORTANT***    
  40.     Ñ    This update is different from the updates provided from Symantec
  41.         for updating to version 4.0.2.  This update MUST be applied to the
  42.         updated v4.0.2 files and NOT to the original v4.0 files.
  43.  
  44.         
  45. HOW TO USE IT
  46. =============
  47.     ÑÑ    Please read through these instructions before you begin.
  48.  
  49.     0.    Be sure that you have already updated your THINK C 4.0 package
  50.         with the version 4.0.2 changes provided from Symantec.  
  51.         
  52.     1.    Make a copy of the v4.0.2 updated THINK Class Library in addition
  53.         to the copy that you originally updated.  You will use one copy to 
  54.         compare the changes and the other to merge the updates into.  You 
  55.         should keep a clean copy of the Symantec v4.0.2 THINK Class Library 
  56.         as backup.
  57.  
  58.     2.    Double-click on the file named "MacProto Update.Script" to launch
  59.         the AutoWeave program.
  60.         
  61.     3.    The AutoWeave program will ask you to locate the updated "THINK
  62.         Class Library" folder. Insert your updated THINK Class Library disk
  63.         in the floppy drive, choose the folder "THINK Class Library" and 
  64.         click OK.
  65.                 
  66.     4.    The AutoWeave program will ask you to locate your copy of the
  67.         "THINK Class Library" folder.  If you followed the installation
  68.         instructions in your THINK C 4.0 User's Manual, this folder
  69.         is your THINK C Folder.
  70.                 
  71.     5.    The AutoWeave program will ask you to locate the "MacProto Update 
  72.         Diffs" folder.  This folder is supplied as part of this update.  
  73.         Select this folder and click OK.
  74.         
  75.     6.    The AutoWeave program will now modify the appropriate files,
  76.         keeping you informed of its progress.  When it has finished,
  77.         you may want to check one or two of the files, to make sure
  78.         that everything worked.  (For example, if you chose the 
  79.         wrong Diffs folder in step 4, the Weaver wouldn't actually
  80.         do anything, although it might act like it did.)
  81.  
  82.  
  83. NOTE:    All changes are marked with the comment, /* PK 4/12/90 */, in the 
  84. source files.  If you wish to find the changes discussed above you can 
  85. search for the comment string.
  86.  
  87.  
  88.  
  89. SUMMARY OF THE CHANGES
  90. ======================
  91.  
  92. CORE SOURCES
  93.  
  94. 1.    CApplication.c
  95.         Various toolbox calls involving Handles were coerced to use type "Handle".
  96.                 
  97. 2.    CBartender.c
  98.         Various toolbox calls involving Handles were coerced to use type "Handle".
  99.         
  100. 3.    CCluster.c
  101.         Various toolbox calls involving Handles were coerced to use type "Handle".
  102.  
  103. 4.    CControl.c
  104.         A call to TrackControl needed the Procedure Pointer parameter coerced
  105.         to type "ProcPtr".        
  106.         
  107. 5.    CDecorator.c
  108.         Several toolbox calls involving windows were coerced to use type "WindowPtr".
  109.         
  110. 6.    CDesktop.c
  111.         Several toolbox calls involving windows were coerced to use type "WindowPtr".
  112.         
  113. 7.    CDocument.c
  114.         Various toolbox calls involving Handles were coerced to use type "Handle".
  115.  
  116. 8.    CError.c
  117.         Various toolbox calls involving Handles were coerced to use type "Handle".
  118.         
  119. 9.    CList.c
  120.         A toolbox call (SetHandleSize) involving Handles was coerced to use type
  121.         "Handle".
  122.         
  123. 10.    CPicture.c
  124.         A toolbox call (HNoPurge) involving Handles was coerced to use type
  125.         "Handle".
  126.         
  127. 11.    CPrinter.c
  128.         A toolbox call (DisposHandle) involving Handles was coerced to use type
  129.         "Handle".
  130.         
  131. 12.    CScrollBar.c
  132.         The toolbox call SetCRefCon needed to have "this" coerced to type "long".
  133.         
  134. 13.    CWindow.c
  135.         The toolbox call SetWRefCon needed to have "this" coerced to type "long".
  136.         
  137. 14.    TBUtilities.c
  138.         Several toolbox calls involving windows were coerced to use type "WindowPeek".
  139.  
  140. CORE SOURCES
  141.  
  142. 1.    CCharGrid.c
  143.         A toolbox call (HUnlock) involving Handles was coerced to use type "Handle".
  144.         
  145. 2.    CColorWindow.c
  146.         A call to GetNewCWindow needed the Procedure Pointer parameter coerced
  147.         to type "CWindowPtr".        
  148.         
  149. 3.    CPatternGrid.c
  150.         The toolbox call to HUnlock and DisposHandle needed their parameters coerced
  151.         to type "Handle".  A call to the toolbox call FillRect was modified to pass
  152.         the array instead of the address to the array to conform to the toolbox prototype.
  153.         
  154. 4.    CStack.c
  155.         The toolbox call to SetHandleSize needed to have the item handle coerced to
  156.         type "Handle".
  157.         
  158. HOW TO CONTACT US
  159. =================
  160. These changes are provided for free and are warranted as such (e.g. you don't pay
  161. for anything and we don't guarantee anything). We use these changes on a day to day
  162. basis in our own projects and hope that they work for you.  If for some reason you
  163. wish to contact us you can send email to:
  164.  
  165. Andrew Johnston        71101,556    or 71101.556@compuserve.com
  166.                                 or AJohnston@applelink.apple.com
  167.  
  168. Phil Keller            71311,136    or 71311.136@compuserve.com
  169.  
  170.